home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / dnet_src.lha / dnet / amiga / doc / dnet.doc < prev    next >
Text File  |  1990-12-13  |  7KB  |  200 lines
  1.  
  2.                 AMIGA-DNET V2.20
  3.  
  4.                 AMIGA CONFIGURATION
  5.  
  6.     ENV:        must be assigned and writable.
  7.     S:DNET.CONFIG   contains configuration info for DNet
  8.     S:DNET.SERVERS  contains the server list for dnet (and paths to
  9.             the server executables)
  10.  
  11.     Any DNet clients you wish to run or have DNet run must be in your path.
  12.     (i.e. FTERM, PUTFILES, GETFILES ...)
  13.  
  14.     Other files will be required if you intend to run DNet *as* a BBS.
  15.  
  16.  
  17.                   DNET OPTIONS
  18.  
  19.     (please refer to S:DNET.CONFIG while reading this)
  20.  
  21.     DNet runs in three basic modes:  AutoAnswer (-a), DialOut (default),
  22.     and Manual (-X).  Each mode has its own default set of security
  23.     parameters.  The shipped defaults assume a hostile enviroment.
  24.     Generally,    AutoAnswer is assumed to be the most hostile since you
  25.     do not know who is calling you up.    DialOut is less so since you know
  26.     who you are dialing, and Manual assumes a non-hostile enviroment.
  27.  
  28.     These three modes also cause DNet to work differently.
  29.  
  30.  
  31. AMIGA/DNET
  32.  
  33.     DialOutMode:
  34.         The default mode is DialOutMode (neither -X or -a given).
  35.         DNet will look for a CONNECT message on carrier detect and
  36.         modify the baud rate according to the AUTA resources.
  37.  
  38.         DNet will set the security modes to the ENVO (originate)
  39.         resources in s:dnet.config
  40.  
  41.         NOTE:  response through the initial window will be slow due
  42.         to DNet's scanning of the resource file s:dnet.config.
  43.  
  44.     -X        Manual mode.  DNet will look for a CONNECT message on
  45.         carrier detect and modify the baud rate on connect
  46.         appropriately.
  47.  
  48.         DNet will set the security modes to the ENVM resources
  49.         which assumes a friendly connection.
  50.  
  51.     -a        Auto Answer mode.  DNet will send the RESM resources at
  52.         the originally specified baud rate to reset the modem
  53.         whenever carrier is lost.
  54.  
  55.         The security modes are set the the ENVA resources, which
  56.         normally assume a hostile enviroment.
  57.  
  58.     -8        Use 8 bits no parity for the initial window rather than
  59.         7 bits even parity.  NOTE!  This only effects the initial
  60.         login window.  The Protocol, when running, always uses
  61.         8 bits no parity.
  62.  
  63.     -bbaud    Set Initial Baud rate (otherwise uses preferences baud
  64.         rate)
  65.  
  66.     -Bbaud    Set Baud used to determine timeouts.  If not set, the
  67.         current baud rate, whatever that is, is used.  If set,
  68.         this value is used to calculate timeouts forever after
  69.         no matter what the actual line baud rate is.
  70.  
  71.         For example, setting this value lower than whatever baud
  72.         rate you normally use will allow for longer line delays
  73.         (such as when dialing through networks and things)
  74.  
  75.     -sclient    Run the specified client program on protocol start.  If
  76.         running a BBS you want to specify the BBS client program
  77.         here.
  78.  
  79.         NOTE:  If the DNET_NORUNCLIENT enviroment variable is set,
  80.         no client program will be run even if this option is
  81.         specified.
  82.  
  83.         The default is to run the FTERM client.
  84.  
  85.  
  86.     -nhostname    Set the hostname (not used)
  87.  
  88.     -h1     Enable Carrier checking.  Default is to not check the CD
  89.         line (reversed from earlier versions).  Note that carrier
  90.         checking is forced if you use -a (auto answer) mode.
  91.  
  92.     -U#     Set the unit number for the low level serial-like device
  93.         to talk over.
  94.  
  95.     -Ddevice    Set the device name for the low level serial-like device
  96.         to talk over (i.e. "serial.device").
  97.  
  98.     -N#     Set the network ID for local client/server rendezvous
  99.  
  100.     -p        Packet Debug mode
  101.  
  102.     -d        Debug mode on
  103.  
  104.     -m0     Select 8 bit packet mode (default is -m1 which selects
  105.         7 bit packet mode)
  106.  
  107.         Note that packets containing binary data will be aproximately
  108.         25% larger in 7 bit mode.  Packets containing ascii data will
  109.         be normal-sized.
  110.  
  111.         In 8 bit mode, simple compression may actually occur... packets
  112.         containing all ascii data 0x00-0x7F will be compressed to make
  113.         use of the 8th bit which would normally be 0, giving an
  114.         aproximately 1/8 speed increase.
  115.  
  116.     -Pn     n = 0    none
  117.             1    xon-xoff
  118.             2    7wire
  119.  
  120.         if -P not specified then the preferences protocol is used.
  121.  
  122.     -Zn     n = 0    8-no parity
  123.             1    7-odd
  124.             2    7-even
  125.             3    7-mark
  126.             4    7-space
  127.  
  128.         if no -Z option is specified the preferences parity and
  129.         wordlength is used.
  130.  
  131.         WARNING:  You CANNOT combine xon/xoff *and* -m0.
  132.  
  133.  
  134.          ---------------------------------------------------
  135.                 SECURITY
  136.  
  137.     The following enviroment variables should exist:
  138.  
  139.     DNET_LEVEL, DNET_READ, DNET_WRITE, DNET_GROUP, DNET_USERID
  140.  
  141.     These are setup automatically by the S:dnet.config file depending on
  142.     the mode (Manual, DialOut (-X), AutoAnswer (-a)) and are read by local
  143.     servers to determine what the remote machine is allowed to do.  These
  144.     variables each hold a single value, normally 0-9 (except for DNET_GROUP
  145.     which can be any number 0-32767).
  146.  
  147.     SGCOPY (server for getfiles):
  148.  
  149.     This is a new server.
  150.  
  151.     DNET_READ and DNET_GROUP  determine which files the remote machine may download
  152.     (read).  In order for the remote to be able to download a file,
  153.     that file and all its parent directories are scanned.  At least
  154.     one comment field must have an AC entry (AC=n) less than or
  155.     equal to the current DNET_READ enviroment variable or sgcopy will
  156.     disallow the download.    If NO comment fields have an AC entry
  157.     the download is disallowed.  If any comment field has an AC
  158.     entry > DNET_READ, the download is disallowed unless a GP entry
  159.     was found (GR=n).
  160.  
  161.     A comment field may have multiple GR entries (GR=n GR=n ...).  If
  162.     any matches DNET_GROUP and all (if any) AC fields are <= DNET_READ,
  163.     the download is allowed.
  164.  
  165.     After that point a download will begin and files/dirs need not have
  166.     AC entries.  However, if any do, it will be checked again DNET_READ
  167.     and the download (for that file or directory) disallowed.
  168.  
  169.     SCOPY (server for putfiles)
  170.  
  171.     This server allows remote machines to upload a file.  That is,
  172.     transfer from the remote machine to the local machine.    DNET_WRITE
  173.     must be 9 or higher or the upload will be disallowed.  Currently,
  174.     the remote machine may upload anywhere so it is suggested that you
  175.     either NOT have the SCOPY server installed or do not set DNET_WRITE
  176.     to 9 or beyond when talking to possibly hostile remote machines.
  177.  
  178.     SPRINT (printer server)
  179.  
  180.     This server copies a stream to PRT:  DNET_WRITE must be at least
  181.     6 or the remote machine will not be allowed to use this server.
  182.  
  183.     SCLI (CLI server)
  184.  
  185.     This server is currently a big hack and requires a special pipe
  186.     device to work (The 1.3 pipe: will not work).
  187.  
  188.     DNET_LEVEL must be at least 9 for a remote machine to be able to
  189.     start a remote cli
  190.  
  191.     STERM  (terminal window server)
  192.  
  193.     This server requires no permissions to operate and allows the
  194.     remote machine to bring up a 'terminal window' to talk you
  195.     through.
  196.  
  197.     AUTOMATIC ENVIROMENT VARIABLE CONFIGURATION CAN BE DONE FROM
  198.     S:DNET.CONFIG
  199.  
  200.